Microsoft Jet and Replication Objects

Visibility Property

       

Indicates the visibility of the replica: Global, Local, or Anonymous.

Return Values

Returns an Enum value that indicates the visibility of the replica within the replica set. It can be one of the following constants:

Constant Description
jrRepVisibilityGlobal Default. The replica is global.
jrRepVisibilityLocal The replica is local.
jrRepVisibilityAnon The replica is anonymous.

Visibility is read-only.

Remarks

A global replica is the typical replica from which you can create all other types of replicas. Changes by a global replica are fully tracked and can be exchanged with any other global replica in the set. The global replica can also exchange changes with any local or anonymous replicas for which it becomes the hub.

Note   The Design Master is a global replica.

Local and anonymous replicas synchronize only with their hub, a global replica. They are not permitted to synchronize with other replicas in the replica set. All local and anonymous replicas always have a priority of 0, therefore, if any of their changes conflict with the global hub replica, the changes will automatically lose in any conflict resolution process. If they convey a non-conflicting change to the hub, the hub assumes authorship of the change.

Only the hub replica is aware of local replicas, and only it can schedule an exchange to a local replica.

No replicas (including the hub replica) are aware of anonymous replicas. The hub replica cannot schedule an exchange to an anonymous replica. However, anonymous replicas are recommended for use on the Internet for mass distribution because system-tracking information is not maintained, and replica size is reduced.

Visibility cannot be changed once the replica is created using the CreateReplica method.

This property can only be read if the database is replicable. An error will occur if the ReplicaType property is not jrRepTypeNotReplicable and the user attempts to read this property.